home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / grafix / anim / xanim6.lha / xanim6 / AUDIO.readme < prev    next >
Encoding:
Text File  |  1987-02-03  |  10.1 KB  |  243 lines
  1.  
  2.  
  3. NOTE: You must edit either the Imakefile or the Makefile to
  4. and uncomment out the AUDIO DEFINES and Libraries for your
  5. machine type before compiling.
  6.  
  7.  
  8. --------------------------------------------------------------
  9. What's Supported
  10. --------------------------------------------------------------
  11.  
  12.  The following is a list of currently supported audio formats: 
  13.  
  14.      AVI 8 and 16 bit RAW(PCM) mono/stereo.
  15.      AVI ADPCM is supported(mono only for now).
  16.      Quicktime 8 and 16 bit RAW(PCM) mono/stereo.
  17.      Quicktime 8 and 16 bit TWOS(signed PCM) mono/stereo.
  18.      Quicktime MAC6 is *NOT* supported. Hell, I don't even know 
  19.         what it is.
  20.  
  21.  The following is a list of currently supported machines:
  22.  
  23.         Sun Sparcs
  24.         NEC EWS workstations
  25.     Sony NEWS 5000 series workstations
  26.         SGI Indigo
  27.         PC  with soundcards running unix/linux/QNX
  28.         Any machine running AudioFile(AF)
  29.         Any machine(or Xterminal) running Net Audio (NAS)
  30.         HP 9000/715 - sort of working - still has problems.
  31.  
  32. --------------------------------------------------------------
  33. Generic Bug's
  34. --------------------------------------------------------------
  35.   + JPEG/MPEG codecs, because of their compute intensive nature, cause
  36.     audio starvation(pops). Solution is to use +b option. Looking
  37.     into other causes.
  38.   + Remote Control Window colors not selectable.
  39.   + HP support pseudo functional. Still needs a lot of work.
  40.   + some odd width animations don't work with X11 Shared Memory
  41.     extension(blank or garbage screen). Use -B as workaround.
  42.     This is an XAnim bug.
  43.  
  44. --------------------------------------------------------------
  45. New(or Fixes) to 2.69.7.6
  46. --------------------------------------------------------------
  47.    + Added MPEG support for Type I frames. Type B and Type P
  48.      frames are currently skipped, but will be added in the
  49.      future. Although I've rewritten large chunks of it, the
  50.      core decoding routines are from mpeg_play.
  51.    + Added Sony NEWS workstation audio support. Thanks to
  52.      Kazushi Yoshida for writing the code.
  53.    + Fixed some bugs in the JPEG routines.
  54.  
  55. --------------------------------------------------------------
  56. New(or Fixes) to 2.69.7.5
  57. --------------------------------------------------------------
  58.    + JPEG: code massively rewritten and optimized. MJPG and IJPG
  59.      video codecs now supported.
  60.    + CVID: some optimization here.
  61.    + SGI: sgi hardware volume is actually exponential. Now XAnim's
  62.      SGI volume function is also exponential
  63.    + Sparc: had some problems with older Sparc audio devices that
  64.      couldn't support NOT having an audio channel selected. The
  65.      Sparc audio ports are now radio button style.
  66.    + Sparc: Some serious incompatibility problems between gcc/cc
  67.      and the /usr/includes and gcc's /usr/includes. Fixed for now.
  68.      Was causing ioctl err 22's during run time on certain
  69.      machine configurations.
  70.  
  71. --------------------------------------------------------------
  72. New(or Fixes) to 2.69.7.4a
  73. --------------------------------------------------------------
  74.    + ALL: You can now add sound to animations that don't have
  75.      sound support(ie FLI/FLC/IFF) by specifying a .wav file
  76.      after the animation file. ie "xanim bart.fli laugh.wav".
  77.      Only some .wav audio compression are currently supported,
  78.      more on the way. NOTE: if audio is longer than animation,
  79.      then animation waits on the last frame until audio is done.
  80.      +f option currently doesn't affect .wav files.
  81.    + PC: best variable not defined in Linux_Closest_Freq() err.
  82.    + PC: libjpeg.a already used by the system and was being found
  83.          1st by the linker causing errors. Renamed to libxajpg.a.
  84.    + ALL: Solution that helps high frame rate anims on SGI machines
  85.      was hurting some others. Now only fixed on SGI machines.
  86.    + ALL: work around to help play some broken FLC's.
  87.       
  88. --------------------------------------------------------------
  89. New(or Fixes) to 2.69.7.4
  90. --------------------------------------------------------------
  91.    + Fixed bug with Quicktime signed(TWOS) 16 bit stereo audio format.
  92.    + Fixed bug with +f option and any 16 bit audio format.
  93.    + +Ae is now be made enabled by default.
  94.    + SPEAKER env variable checked(INTERNAL/HEADPHONES/EXTERNAL/NONE).
  95.    + RemoteControl Window made smaller and now has dynamically
  96.      changing bitmaps to better indicate current function of
  97.      the buttons.
  98.    + RemoteControl window no longer overlaps Anim Window.
  99.    + "+Ar" option enables/disables RemoteControl Window.
  100.    + "z" window command pops creates/destroys RemoteControl Window
  101.      on-the-fly.
  102.    + More fine tuning of video/audio routines.
  103.    + AVI ADPCM is no longer decompressed 1st. +f now works with
  104.      this audio codec.
  105.    + AVI JPEG Video Codec support added, including interleaved frames.
  106.    + AVI MJPG Video Codec support added.
  107.    + HP: finally code sound out of an HP. Code still has a ways to go.
  108.          And HP Aserver library seems to be part of the problem.
  109.  
  110. --------------------------------------------------------------
  111. Configuring For Your Machine
  112. --------------------------------------------------------------
  113.  
  114.   You'll need to edit the Makefile or the Imakefile. Go to the Audio 
  115.   section and uncomment out the DEFINE's associated with your machine
  116.   type. Make sure no other machine's DEFINE's are uncommented. That 
  117.   would be bad. 
  118.  
  119.  
  120. --------------------------------------------------------------
  121. Sun Sparc Specific Info
  122. --------------------------------------------------------------
  123.  
  124.   IF YOUR ARE USING OPENWINDOWS THEN YOU MUST USE Makefile.unx
  125.   AND YOU MUST EDIT THE CHANGES REQUIRED. This is because of
  126.   bugs/deficiencies with the OpenWindows Athena libraries.
  127.   See top of Makefile.unx for more details.
  128.  
  129.   Having some problems with gcc, because it wants to use it's
  130.   own include files and they're usually wrong(or out of date).
  131.   Use cc if this happens.
  132.  
  133.   If you are using Solaris, use the -DSOLARIS define in the Makefile.
  134.  
  135. --------------------------------------------------------------
  136. Linux(soundcard) Specific Info
  137. --------------------------------------------------------------
  138.  
  139.   Compiles and runs on 8 bit and 16 bit sound cards(sound driver 2.5 and 2.99).
  140.   Some video/audio syncing problem with driver 2.5 that got better with 2.99.
  141.  
  142. --------------------------------------------------------------
  143. SGI Specific Info
  144. --------------------------------------------------------------
  145.  
  146.   NEWSFLASH. The audio stuff should be include now in Irix 5.3. You
  147.   might be able to obtain them for free if you have the Irix 5.1 or
  148.   Irix 5.2 releases, but that's just a rumor.
  149.  
  150.   If you have Irix 5.1 or greater then make sure you have installed 
  151.   the digital media development subsystem (dmedia_dev.sw.audio) off
  152.   of the CD-ROM.  
  153.  
  154.   If this isn't on your CD_ROM then read on...
  155.  
  156.   "according to the 5.2 readme first page, it says
  157.    that the Audio Development software has been moved from
  158.    the IDO to a purchasable option, IRIS media libraries. "
  159.  
  160.   And you either have to contact SGI and buy it($495) OR
  161.  
  162.   In the meantime, you can compile XAnim on an Irix 4.0.5 machine
  163.   and the XAnim binary should work back on the original Irix 5.1
  164.   or 5.2 machine. 
  165.  
  166.   Once XAnim audio is stablized on SGI's, I should be able to provide
  167.   an xanim executable.  NOTE: I don't have nor can I legally distribute
  168.   the SGI audio libraries and include files.
  169.  
  170. --------------------------------------------------------------
  171. HP Specific Info
  172. --------------------------------------------------------------
  173.  
  174.   Written and getting better, but still has a ways to go.
  175.  
  176.   With HP's you need to start up the system Audio Server before
  177.   you can use ANY audio program. Here's how(from the Audio.man
  178.   page on an HP 700/915):
  179.  
  180.            Step 1.   Start the NCS Local Location Broker Daemon.
  181.                      Task 1.   If you are not already superuser, log in as
  182.                                superuser.
  183.                      Task 2.   Enter the command line /usr/etc/ncs/llbd&&&&.
  184.                                To make llbd start automatically at boot
  185.                                time, edit the file /etc/netncsrc and change
  186.                                the line START_LLBD=0 to START_LLBD=1.
  187.            Step 2.   Reboot.
  188.            Step 3.   Set the AUDIO environment variable to specify the node
  189.                      where the audio client should look for the audio
  190.                      server.  If AUDIO is not set or if it is set to :0, the
  191.                      client connects with a server on the same node.
  192.  
  193.                      To specify that the client should connect to a server
  194.                      on another node, set
  195.  
  196.                           AUDIO = node_name: (Korn, Bourne, and POSIX
  197.                           shells)
  198.                           export AUDIO
  199.  
  200.                      or
  201.  
  202.                           setenv AUDIO node_name: (C shell)
  203.  
  204.            Step 4.   Normally, the audio server starts whenever the system
  205.                      is booted.  Check for the existence of the Aserver
  206.                      processes by typing
  207.  
  208.                      ps -e | grep Aserver
  209.  
  210.            You should see two Aserver processes.  If the server is not
  211.            running, start the audio server by hand by typing
  212.  
  213.                 /usr/audio/bin/Aserver
  214.  
  215.            Then type
  216.  
  217.                 ps -e | grep Aserver
  218.  
  219.            and check that there are two active server processes.
  220.  
  221. --------------------------------------------------------------
  222. AudioFile (AF) Specific Info
  223. --------------------------------------------------------------
  224.  
  225.   I haven't brought up AF yet on my machine. I'm assumming it work.
  226.  
  227. --------------------------------------------------------------
  228. Net Audio (NAS) Specific Info
  229. --------------------------------------------------------------
  230.  
  231.   I have brought NAS up on my machine and have fine tuned it. NAS
  232.   has some deficiencies that make it difficult to keep audio/video
  233.   sync. Hopefully they'll improve it and likewise I'll improve 
  234.   my understanding of it.
  235.  
  236. --------------------------------------------------------------
  237. Any comments, questions, bugs, fixes, etc  email me at podlipec@wellfleet.com
  238.  
  239. If you make changes to the audio code, please send entire 
  240. xanim_audio.c file unless the patches are minor.
  241.  
  242. --------------------------------------------------------------
  243.